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1. About this guide 


Objectives and target audience 
This guide describes how to install and configure the Skrill X-cart module. It assumes that you have an 
existing X-cart installation. 


Conventions used in this guide 
The table below lists some of the conventions used in this guide. 


Table 1-1: List of conventions 

















Convention Description 

Code example Used to illustrate example code, functions and commands. 
File path Used to indicate a file path or folder structure. 

Glossary Glossary term 

Menu1 > Menu option2 > Indicates a menu path. 
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2. Introduction 


What is the X-cart module? 
X-cart is an eCommerce platform, which provides online merchants with a flexible shopping cart 
system, as well as control over the look-and-feel, content and functionality of their online store. 


X-cart has been fully integrated with Skrill’s online payment solution called Quick Checkout. Installing 
and configuring the Skrill Payment Solution module provides a simple, secure and convenient option 
for connecting to Skrill’s online payment processing platform via X-cart. 


Skrill customers using X-cart have access to a wide range of card and alternative payment methods. 


Signing up for a Skrill account 
Before you can start accepting payments through Skrill, you need to open a free merchant account 
by completing the online application form here. 


Once your application has been approved you can configure your Skrill credentials in your Skrill 
merchant account and then copy them in your X-cart backend and start taking payments. 
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3. Installing and configuring X-cart 


Secret Word and API Password 
It is mandatory to setup a secret word and API/MQI password for your Skrill merchant account before 
configuring the Skrill X-cart module. The secret word is used to authenticate the data sent back to your 
X-cart server after payment. You must obtain the IP address of your X-cart server to configure the 
API/MQI password. You can find this IP address by executing the following command from a command 
prompt: 


ping <server domain name> 
For example: 


ping example.x-cartserver.com 
Pinging example.x-cartserver.com [145.76.160.206] with 32 bytes of data: 


Make a note of the set of numbers in the square brackets. This is the IP address. Now you have the IP 
address, you can setup the secret word and API/MQI password as follows: 


Log in to your Skrill merchant account at www.skrill.com 
Go to Settings > Developer Settings (Figure 3-1) 
Set API / MQI Password using the toggle, type and confirm by clicking Save 
For each section, specify the IP address(es) or IP address range of your X-cart server. This 
prevents payment or money transfer requests from other IP addresses if your secret word 
or API password is compromised. All requests from other IP addresses are denied. Access 
can be granted to: 

e Asingle IP address (e.g. 145.76.160.206 using the example above) 

e Multiple IP addresses, separated by space (e.g. 192.168.0.2 10.0.0.2) 

e Asubnet in CIDR notation (e.g. 192.168.0.0/24) 
5. Set Secret Word using the toggle, type and confirm by clicking the Save button 
Note: Your Secret Word must contain at least: 8 characters, 1 uppercase letter, 1 lowercase letter, 
and 1 number. 


wwa 
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Home > Setting 
GY Hom Developer Settings 
Configure API and securit s for your wallet account 
> Transfers 
Bla Bla Wallet 
Ñ Banking ID: 116404455 
@ Balances Developer Settings : Bla Bla Wallet BI mmm i 3 SE mm WE bu E+] = i m 
s All Transactions ‘Wallet IP Whitelisting API / MQI / GSR / CVT Management API Documentation 
@ Users 
C) Automated Payment Interface (API) Disabled ©] 
© settings 


Allow requests to the API only from the following IP addresses. 








& Account Settings Your API secure IP addresses: ( 2 Edit + add) 








&B_ Developer Settings 
87.120.141.129 


Wallet Label Settings 


© Merchant Information 


C) Merchant Query Interface (MQI) Disabled 


Allow requests to the MQI only from the following IP addresses. 


Your MQI secure IP addresses: + Add ) 


No active secure IP address found 





[Œ Gateway Secure Restriction (GSR) Disabled 


Allow gateway sessions to be generated only from the following IP addresses. 


Your GSR secure IP addresses: 


©) SetAPI/MQIPassword Enabled 


Please provide API/MQI Password in order to enable the service. 


Current Password 
New Password 


Confirm Password 


C O 


E SetSecretWord Enabled 


Please provide Secret Word in order to enable the service. 


New Password 


Confirm Password 


C O 


tings | PrivacyNotice | Regulatory Disclosures | Cookie Notice 
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Figure 3-1: Configuring a Secret Word and API/MQI Password 


Download Skrill on your X-cart backend 

To download Skrill from the marketplace follow the below steps: 
1. Goto my Addons 

Type Skrill in the top right-hand side 

Click on Install 


PwhD 


Once Skrill is installed you will receive a pop confirming Skrill is enabled 
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The next stage of the X-cart integration is to configure the X-cart module to connect to your Skrill 
account. The steps are as follows: 


Click on Store Setup 


Type Skrill in add payment method 

Choose all the payment methods you would like to enable for your store through Skrill 

Click add for each payment method 

Please type your Skrill credentials for one Skrill payment method and it will be prefilled for the 
remaining ones you added (Figure 3-2) 


Dee ns: 
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Skrill All Card Types Settings 


Support 


This payment method is | on | 


Do you have questions? 
Contact Skrill at newbusiness@paysafe.com 


Skrill Quick Checkout enables you to take direct payments from credit cards, debit cards and over 80 other local payment options in nearly 200 countries. The 
highly competitive rates are published on the Skrill website www. skrill.com 


Email address of your Skrill test@merchant.com 
account 
Skrill Customer ID 11223344 
Secret word abc123 e 
Order id prefix xcart e 


Test mode 





Figure 3-2: Skrill Settings with example values in X-cart backend 


Configure Skrill Settings 
Configure the Skrill Settings as follows: 
1. Enter your Skrill Merchant account ID in the Merchant ID field. This is the Customer ID of your 
merchant account 


2. Enter your Skrill Merchant account email address 
3. Enter the Secret word that you set up in the previoussection 


Table 3-1: Skrill Settings 





Field Name Description Format/ Example 





Merchant ID Your unique merchant identifier. This is the 58010731 
Customer ID of your merchant account. 





Merchant The email address linked to your Skrill merchant | techpubs@skrill.com 
Account (email) | account (created by you when you first signed up 
for a Skrill merchant account). 





Secret word Enter the secret word configured for your Skrill N/A 
account here. This feature is mandatory and 
ensures the integrity of the data posted back to 
your x-cartservers. 
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4. Customer Experience 


This section describes the customer’s checkout experience when using the Skrill x-Cart module. 


Note: We only describe the Checkout process from the payment selection step onwards as the 
previous steps are unchanged. 


The steps are as follows: 


1. Click a payment method from the list of available payment methods (this list depends on the 
customer’s country, the payment options configured for your Skrill account and the payment options 
configured in the Skrill x-Cart Module 


@ Secure Checkout C shipping — [E Payer 


Billing address Payment method 


Test Merchant VISA 
Ber 1 item in cart $6.49 


y (nastercara Shipping cost $5.61 


z Test Merchant 
Choose another address t Mercha 


$12.10 


ms & Conditions 


Figure 4-1: x-Cart Checkout Payment selection showing different payment methods 
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2. Enter Payment details in the Skrill Payment Form 


® English Germany 


179.95&UR ©  Semoshop 


Skrill =Œ RAPIDA © 


Card number 


Expiry date Security code 
MM || YY CVV 


Cardholder name 


Type the name exactly as it appears on the card 


PAY NOW 


Cancel 
= Powered 
C= Skrill 


Figure 4-2: Enter Payment Details in the Skrill Payment Form 
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3. Click Pay Now to complete the payment. If all is correct, the payment form will display the 
following screen: 


@ English Germany 


179.95FUR © |  Semonop 


r 





Successful payment 


rem Skrill 


Figure 4-3: Successful Payment 
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Removing or reducing the header and reducing the footer 

You can request a version of the Skrill payment form without the Skrill header and amount fields. The 
security logo is also removed from the footer, to reduce its size. To enable this option, please contact 
Skrill Merchant Services and ask for the Reduced Header and Footer option. This option is shown in 
the screenshot below (The standard payment form is shown on the left and the reduced header and 
footer option on the right). 


© English France 
10.00«ve : 
@ Engish France English ons 
= @ = 
DP = 
=| © =j @ 
vsa SD 
visa SD vss € 
a TE 
Expiry date Sec code 
MM YY CV = s ya Expiry date Security code 
MM | YY cv = 
MM | YY cw E 
Cardholder name Cardholder name 
First Last First 5 Cardholder name 
irst Last 
First Last 
Email address Why? Email address Why? 
Email address Why? 
Reawresty Powered by 
v Skrill Zm- Skrill Powered by Skrill 


Figure 4-4: Reduced Header and Footer Option 
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5. Refund Information 


Currently refund is not supported in x-Cart. To complete refund, please login to your Skrill merchant 


account and follow the below steps: 


Click on All transactions 

Find the transaction which should be refunded 
Click refund from right hand side column 

Type the amount which should be refunded 
Click confirm return 


ve wW Noe 


Once you have completed the refund in your Skrill account, please login to your x-Cart account to 


update transaction status manually (Figure 5-1) 


Order #6 


General Info Create Return Invoice Messages 


View order history 


St Placed on Aug 31, 2020, 11:07 Staff Note 


by Test Merchant 


olga.fahrieva@paysafe.com 


| Payment Method Ñ Shipping Method 

; , Fulfillment status 
Skrill MasterCard Courier 
Transaction ID: Payment status 


000008-3W9T 


Billing address Shipping address 


Test Merchant the same as billing 
test@gmail.com 

Berlin 

Germany 

90001 

Phone: 000000000000000 


Figure 5-1: Update Refund Payment 


Delivered 






Awaiting payment 
Partially Paid 

Paid 

Cancelled 


Refunde 


Tracking numbers are not added yet 
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6. Testing 


We provide test cards shown in the table below for use with test merchant accounts. When using these 
card numbers enter an expiry date in the future and a random CVV number. 


Table 6-1: Test Cards 

















Brand Card Number 
MasterCard 5438311234567890 
Visa 4000001234567890 








Should you wish to test Skrill in DEMO shops please get in touch with Skrill support at 
newbusiness@paysafe.com, so we can provide you with access. 
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